<html DIR="LTR" xmlns:MSHelp="http://msdn.microsoft.com/mshelp" xmlns:ddue="http://ddue.schemas.microsoft.com/authoring/2003/5" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:tool="http://www.microsoft.com/tooltip"><head><META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=Windows-1252"></META><META NAME="save" CONTENT="history"></META><title>Using Build Explorer to View and Manage Queued, Ongoing, and Completed Builds</title><STYLE TYPE="text/css">
    body
    {
        background:    #FFFFFF;
        color: #000000;
        font-family:    Verdana;
        font-size: medium;
        font-style: normal;
        font-weight: normal;
        margin-top:    0;
        margin-bottom:    0;
        margin-left:    0;
        margin-right:    0;
        width:    100%;
    }
    
    a
    {
        color:    #0000FF;
    }
    
    a:visited
    {
        color:    #0000FF;
    }
    
    a:link
    {
        color:    #0000FF;
    }
    
    a:hover
    {
        color:    #FF0000;
        cursor: hand;
    }
    
    a:active
    {
        color:    #FF0000;
        cursor: hand;
    }
    
    div#mainSection
    {
        font-size: 70%;
        width: 100%;
    }
    
    div#mainBody
    {
        font-size: 90%;
        margin-left:    5;
        margin-top: 10;
        padding-bottom: 20;
    }
    
    div#header
    {
        background-color: #D4DFFF;
        padding-top:    0;
        padding-bottom:    0;
        padding-left:    0;
        padding-right:    0;
        width:    100%;
    }
    
    div#header table
    {
        border-bottom-color: #C8CDDE;
        border-bottom-style: solid;
        border-bottom-width: 1;
        width:    100%;
    }
    
    span#runningHeaderText
    {
        color: #003399;
        font-size: 90%;
    }
    
    span#nsrTitle
    {
        color: #003399;
        font-size: 125%;
        font-weight: 600;
    }
    
    div#header table td
    {
        color: #0000FF;
        font-size: 70%;
        margin-top:    0;
        margin-bottom:    0;
        padding-right: 20;
    }
    
    div#header table tr#headerTableRow3 td
    {
        padding-bottom: 2;
        padding-top: 5;
    }
    
    div#header table#bottomTable
    {
        border-top-color: #FFFFFF;
        border-top-style: solid;
        border-top-width: 1;
        text-align: left;
    }
    
    div#footer
    {
        font-size: 90%;
        margin-top:    0;
        margin-bottom:    0;
        margin-left:    0;
        margin-right:    0;
        padding-top:    2;
        padding-bottom:    2;
        padding-left:    2;
        padding-right:    2;
        width:    100%;
    }
    
    hr#footerHR
    {
        border-bottom-color: #EEEEFF;
        border-bottom-style: solid;
        border-bottom-width: 1;
        border-top-color: C8CDDE;
        border-top-style: solid;
        border-top-width: 1;
        height: 3;
        color: #D4DFFF;
    }
    
    div.section
    {
        padding-top:    2;
        padding-bottom:    2;
        padding-left:    16;
        padding-right:    15;
        width:    100%;
    }
    
    .heading
    {
        font-weight:    bold;
        margin-top:        18;
        margin-bottom:    8;
    }
    
    h1.heading
    {
        color: #003399;
        font-size:    125%;
    }
    
    .subHeading
    {
        font-weight:    bold;
        margin-bottom:    4;
    }
    
    h3.subHeading
    {
        color:  #003399;
        font-size: 115%;
        font-weight: bold;
    }
    
    h4.subHeading
    {
        color: #003399;
        font-size: 105%;
    }
    
    h5.subHeading
    {
        color: #003399;
        font-size: 100%;
    }
    
    img.toggle
    {
    	border: 0;
	margin-right: 5;
    }

    img.copyCodeImage
    {
	border: 0;
	margin-right: 3;
    }

    img.downloadCodeImage
    {
	border: 0;
	margin-right: 3;
    }

    img.viewCodeImage
    {
	border: 0;
	margin-right: 3;
    }

    img.note
    {
	border: 0;
	margin-right: 3;
    }

    img#languageFilterImage
    {
	border: 0;
	margin-left: 10;
	vertical-align: middle;
    }

    img#membersOptionsFilterImage
    {
	border: 0;
	margin-left: 10;
	vertical-align: middle;
    }

    img#toggleAllImage
    {
	margin-left: 4;
	vertical-align: middle;
    }
    
    div#mainSection table
    {
        border: 0;
        font-size: 100%;
        width:    100%;
    }
    
    div#mainSection table th
    {
        background:    #EFEFF7;
        border-bottom-color: #C8CDDE;
        border-bottom-style: solid;
        border-bottom-width: 1;
        color: #000066;
        padding-left: 5;
        padding-right: 5;
    }
    
    div#mainSection table td
    {
        background:    #F7F7FF;
        border-top-color: #FFFFFF;
        border-top-style: solid;
        border-top-width: 1;
        padding-left: 5;
        padding-right: 5;
    }
    
    div#mainSection table td.imageCell
    {
        white-space: nowrap;
    }
    
    div.code table
    {
        border: 0;
        font-size: 95%;
        margin-bottom: 5;
        width: 100%
    }
    
    div.code table th
    {    
        background:    #EFEFF7;
        border-bottom-color: #C8CDDE;
        border-bottom-style: solid;
        border-bottom-width: 1;
        color: #000066;
        font-weight: bold;
        padding-left: 5;
        padding-right: 5;
    }
    
    div.code table td
    {
        background:    #F7F7FF;
        border-top-color: #FFFFFF;
        border-top-style: solid;
        border-top-width: 1;
        padding-left: 5;
        padding-right: 5;
        padding-top: 5;
    }
    
    div.alert table
    {
        border: 0;
        font-size: 100%;
        width:    100%;
    }
    
    div.alert table th
    {
        background:    #EFEFF7;
        border-bottom-width: 0;
        color: #000066;
        padding-left: 5;
        padding-right: 5;
    }
    
    div.alert table td
    {
        background:    #F7F7FF;
        border-top-color: #FFFFFF;
        border-top-style: solid;
        border-top-width: 1;
        padding-left: 5;
        padding-right: 5;
    }
    
    .copyCode
    {
        color: #0000ff;
        font-size: 90%;
        font-weight: normal;
    }
    
    .downloadCode
    {
        color: #0000ff;
        font-size: 90%;
        font-weight: normal;
    }
    
    .viewCode
    {
        color: #0000ff;
        font-size: 90%;
        font-weight: normal;
    }
    
    div.code pre
    {
        font-family:    Monospace, Courier New, Courier;
        font-size: 105%;
        color:    #000066;
        word-wrap:    break-word;
    }
    
    code
    {
        font-family:    Monospace, Courier New, Courier;
        font-size: 105%;
        color:    #000066;
    }
    
    dl
    {
        margin-top:    0;
        padding-left:    1;
    }
    
    dt
    {
        font-style:    italic;
    }
    
    dd
    {
        margin-bottom:    0;
        margin-left:    0;
    }
    
    ul
    {
        margin-left: 17;
        list-style-type: disc;
    }
    
    ul ul
    {
        margin-bottom: 4;
        margin-left: 17;
        margin-top: 3;
        list-style-type: disc;
    }
    
    ol
    {
        margin-left: 24;
        list-style-type: decimal;
    }
    
    ol ol
    {
        margin-bottom: 4;
        margin-left: 24;
        margin-top: 3;
        list-style-type: lower-alpha;
    }
    
    li
    {
        margin-bottom: 3;
    }
    
    p
    {
        margin-top: 0;
        margin-bottom: 15;
    }
    
    .tip
    {
        color:    #0000FF;
        font-style: italic;
        cursor:hand;
        text-decoration:underline;
    }
    
    .languageFilter
    {
        color:    #0000FF;
        cursor:hand;
        text-decoration:underline;
        padding-bottom:4;
    }
    
    .math
    {
        font-family: Times New Roman;
        font-size: 125%
    }
    
    .sourceCodeList
    {
        font-family: Verdana;
        font-size: 90%;    
    }
    
    pre.viewCode
    {
        width: 100%;
        overflow: auto;
    }
    
    MSHelp\:link
    {
        text-decoration: underline;
        color: #0000ff; 
        hoverColor: #3366ff;
        filterString: ;
    }
</STYLE>
</head>
<body><input type="hidden" id="userDataCache" class="userDataStyle"></input><input type="hidden" id="hiddenScrollOffset"></input><img id="dropDownImage" style="display:none; height:0; width:0;" src="drpdown.gif"><img id="dropDownHoverImage" style="display:none; height:0; width:0;" src="drpdown_orange.gif"><img id="collapseImage" style="display:none; height:0; width:0;" src="collapse.gif"><img id="expandImage" style="display:none; height:0; width:0;" src="exp.gif"><img id="copyImage" style="display:none; height:0; width:0;" src="copycode.gif"><img id="copyHoverImage" style="display:none; height:0; width:0;" src="copycodeHighlight.gif"><div id="header"><table width="100%" id="topTable"><tr id="headerTableRow1"><td align="left"><span id="runningHeaderText"></span></td></tr><tr id="headerTableRow2"><td align="left"><span id="nsrTitle">Using Build Explorer to View and Manage Queued, Ongoing, and Completed Builds</span></td></tr><tr id="headerTableRow3"></tr></table></div><div id="mainSection"><div id="mainBody"><div id="allHistory" class="saveHistory"></div>
				<p>You can use <b>Build Explorer</b> to view and manage details about queued, ongoing, and completed builds. You use the <b>Queued</b> tab to view and manage the builds that were queued within the last five minutes. You use the <b>Completed</b> tab to view and manage older builds.</p>
				<p>
					<b>Required Permissions</b>
				</p>
				<p>To perform this procedure, you must have the <b>View builds</b>, <b>View build definition</b>, and <b>View build resources</b> permissions set to <b>Allow</b>. For more information, see the following topic on the Microsoft Web site: <a href="http://go.microsoft.com/fwlink/?LinkID=182567" target="_blank" alt=""><linkText xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">Team Foundation Server Permissions</linkText></a>.</p>
			<h1 class="heading">Common Tasks</h1><div id="sectionSection0" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
					<h3 class="subHeading" xmlns=""></h3><table xmlns=""><tr>
								<th>
									Task
								</th>
								<th>
									Supporting Content
								</th>
							</tr><tr>
							<td>
								<p>
									<b>View build results:</b> You can open <b>Build Explorer</b> to view information about queued, running, and completed builds.</p>
							</td>
							<td>
								<ul><li class="unordered">
										
											<a href="#OpenBuildExplorer">Open Build Explorer and View Build Results</a>
										<br /><br />
									</li></ul>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Manage queued and running builds:</b> You can stop an in-progress build. You might do this if, for example, you discovered that you did not check in your changes before requesting a build.</p>
							</td>
							<td>
								<ul><li class="unordered">
										
											<a href="#ManagedQueuedRunning">Manage Queued and Running Builds</a>
										<br /><br />
									</li></ul>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Find specific builds:</b> You can apply filters by build definition, build quality, and by the date on which builds were completed. By doing this, you can more easily find the builds that you want to view and manage.</p>
							</td>
							<td>
								<ul><li class="unordered">
										
											<a href="#FilterBuildExplorer">Filter the Results in Build Explorer</a>
										<br /><br />
									</li></ul>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Managed completed builds:</b> After a build has completed, you can rate the quality of the build. You can request a new build for any completed build. You can delete completed builds that are no longer required.</p>
								<p>You can specify that a build should be retained indefinitely, as an exception of the defined retention policy. For example, you might do this for released builds.</p>
							</td>
							<td>
								<ul><li class="unordered">
										
											<a href="#RateBuildQuality">Rate the Quality of a Completed Build</a>
										<br /><br />
									</li><li class="unordered">
										
											<a href="#QueueNewBuild">Queue a New Build</a>
										<br /><br />
									</li><li class="unordered">
										
											<a href="#DeleteBuild">Delete a Completed Build</a>
										<br /><br />
									</li><li class="unordered">
										
											<a href="#RetainIndefinitely">Retain a Build Indefinitely</a>
										<br /><br />
									</li></ul>
							</td>
						</tr></table>
				</content></div><a name="OpenBuildExplorer"></a><a name="buildexplorer#OpenBuildExplorer"></a><h1 class="heading">Open Build Explorer and View Build Results</h1><div id="sectionSection1" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
					<p xmlns="">You can use <b>Build Explorer</b> to view all queued, running, and completed builds. For all listed builds, you can view details for that build.</p>
					<p xmlns="">For each build, the following information is available in <b>Build Explorer</b>:</p>
					<h3 class="subHeading" xmlns=""></h3><table xmlns=""><tr>
								<th>
									Column
								</th>
								<th>
									Description
								</th>
							</tr><tr>
							<td>
								<p>State/Result (information icon)</p>
							</td>
							<td>
								<p>Indicates the current build state. Valid states include active (queued), in progress (running), stopped, postponed, succeeded, and failed. Point to any state icon for a description of its meaning.</p>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Build Definition</b>
								</p>
							</td>
							<td>
								<p>The name of the build definition that was used to queue the build.</p>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Priority</b>
								</p>
							</td>
							<td>
								<p>The priority of the build.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									
										<b>Priority</b> appears only on the <b>Queued</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Date Queued</b>
								</p>
							</td>
							<td>
								<p>The date and time when the build was queued.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									
										<b>Date Queued</b> appears only on the <b>Queued</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Requested By</b>
								</p>
							</td>
							<td>
								<p>The name of the person who requested the build.</p>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Build Controller</b>
								</p>
							</td>
							<td>
								<p>The build controller that was used to run the build.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									
										<b>Build Controller</b> appears only on the <b>Queued</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr><tr>
							<td>
								<p>Retain Indefinitely (lock icon)</p>
							</td>
							<td>
								<p>Indicates that the build should be retained indefinitely and should not be removed when the retention policy would otherwise remove it.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									Retain Indefinitely appears only on the <b>Completed</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Name</b>
								</p>
							</td>
							<td>
								<p>The name of a completed build. The build name consists of the build definition concatenated with the build number.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									
										<b>Name</b> appears only on the <b>Completed</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Build Quality</b>
								</p>
							</td>
							<td>
								<p>The quality of a completed build. This field is blank until a build quality is assigned.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									
										<b>Build Quality</b> appears only on the <b>Completed</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr><tr>
							<td>
								<p>
									<b>Date Completed</b>
								</p>
							</td>
							<td>
								<p>The date and time when the build completed.</p>
								<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
									
										<b>Date Completed</b> appears only on the <b>Completed</b> tab.<p></p>
								</td></tr></table><p></p></div>
							</td>
						</tr></table>
					<p xmlns="">Additional details are available if you view the build report for a specific build.</p>
					<h4 class="subHeading" xmlns=""><b>To open Build Explorer</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ul xmlns=""><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">In <b>Team Explorer</b>, expand the team project for which you want to view builds, and then double-click the <b>Builds</b> node.</p>
									<p xmlns="">You can filter the list of build results to more easily find a specific build. For more information, see <a href="#FilterBuildExplorer">Filter the Results in Build Explorer</a>.</p>
								</content>
							</li></ul></ddue:steps></div>
					<h4 class="subHeading" xmlns=""><b>To view details for a build</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ol class="ordered" xmlns=""><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">Perform one of the following tasks:</p>
									<ul xmlns=""><li class="unordered">
											To view details for a recently queued build, click the <b>Queued</b> tab.<br /><br />
											<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
												If you refresh the tab after five minutes, queued builds no longer appear on the <b>Queued</b> tab. You must instead view the <b>Completed</b> tab.<p></p>
											</td></tr></table><p></p></div>
										</li><li class="unordered">
											To view details for a completed build, or a build that was queued more than five minutes ago, click the <b>Completed</b> tab.<br /><br />
										</li></ul>
								</content>
							</li><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">In <b>Build Explorer</b>, double-click the build for which you want to view details.</p>
									<p xmlns="">A build details report appears in a new window. The title bar for the window consists of <i>BuildName</i>_<i>BuildNumber</i>, where <i>BuildName</i> is the name of the build definition and <i>BuildNumber</i> is the build number.</p>
								</content>
							</li><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">(Optional) You can perform any of the following tasks from the build details report:</p>
									<ul xmlns=""><li class="unordered">
											Click <b>View Summary</b> to see a summary of the build results.<br /><br />
										</li><li class="unordered">
											Click <b>View Log</b> to see the details that were saved in the build log.<br /><br />
										</li><li class="unordered">
											Click <b>Open Drop Folder</b> to open the folder to which the build output was copied.<br /><br />
										</li><li class="unordered">
											Click <b>Delete Build</b> to delete the build from the server.<br /><br />
											<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Caution </th></tr><tr><td>
												You cannot undo this operation. You should delete builds only if you are certain that they are no longer required. In most organizations, the build retention policy is used to determine when builds are automatically removed. For more information, see <a href="builddef2010.htm#RetentionPolicy">Specify the Retention Policy for the Build</a> (Visual Studio Team Foundation Server 2010) or <a href="builddef2008.htm#RetentionPolicy">Specify the Retention Policy for the Build</a> (Visual Studio Team System 2008 Team Foundation Server).<p></p>
											</td></tr></table><p></p></div>
										</li><li class="unordered">
											Click the list of build quality values to specify the quality of the completed build.<br /><br />
											<div class="alert"><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Note </th></tr><tr><td>
												You cannot specify a build quality for builds that have not completed.<p></p>
											</td></tr></table><p></p></div>
										</li></ul>
								</content>
							</li></ol></ddue:steps></div>
				</content></div><a name="FilterBuildExplorer"></a><a name="buildexplorer#FilterBuildExplorer"></a><h1 class="heading">Filter the Results in Build Explorer</h1><div id="sectionSection2" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
					<p xmlns="">You can use the filters in <b>Build Explorer</b> to filter the completed builds by build definition name, build quality, or the date-range on which the builds were completed.</p>
					<h4 class="subHeading" xmlns=""><b>To filter build results</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ol class="ordered" xmlns=""><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">In <b>Build Explorer</b>, click the <b>Queued</b> tab to show the results of recently queued builds. To show older or completed builds, click the <b>Completed</b> tab.</p>
								</content>
							</li><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">Perform any of the following tasks:</p>
									<ul xmlns=""><li class="unordered">
											To find builds created from a specific build definition, in <b>Build definition</b>, click the definition for which you want to see results.<br /><br />
										</li><li class="unordered">
											To find builds of a specific quality, in <b>Quality filter</b>, click the quality for builds that you want to display.<br /><br />
										</li><li class="unordered">
											To find builds that completed in a specified range of dates, in <b>Date filter</b>, click the date range that corresponds to the time period that you want.<br /><br />
										</li></ul>
									<p xmlns="">As you specify filter criteria, the list of build results updates immediately.</p>
								</content>
							</li></ol></ddue:steps></div>
				</content></div><a name="ManagedQueuedRunning"></a><a name="buildexplorer#ManagedQueuedRunning"></a><h1 class="heading">Manage Queued and Running Builds</h1><div id="sectionSection3" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
					<p xmlns="">After a build has been queued and before it has completed, you can only cancel it. You cannot rate its quality or delete it while it is queued or running.</p>
					<h4 class="subHeading" xmlns=""><b>To stop an in-progress build</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ul xmlns=""><li>
								<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
									<p xmlns="">In <b>Build Explorer</b>, right-click an <b>In Progress</b> build on the <b>Queued</b> or <b>Completed</b> tab, and then click <b>Stop</b>.</p>
								</content>
							</li></ul></ddue:steps></div>
				</content></div><a name="ManageCompletedBuilds"></a><a name="buildexplorer#ManageCompletedBuilds"></a><h1 class="heading">Manage Completed Builds</h1><div id="sectionSection4" class="section"><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
					<p xmlns="">You can perform a variety of actions on completed builds. You can perform these actions from <b>Build Explorer</b> or from the build results report for a completed build.</p>
					<p xmlns="">
						<b>In this section</b>
					</p>
					<ul xmlns=""><li class="unordered">
							
								<a href="#RateBuildQuality">Rate the Quality of a Completed Build</a>
							<br /><br />
						</li><li class="unordered">
							
								<a href="#QueueNewBuild">Queue a New Build</a>
							<br /><br />
						</li><li class="unordered">
							
								<a href="#DeleteBuild">Delete a Completed Build</a>
							<br /><br />
						</li><li class="unordered">
							
								<a href="#RetainIndefinitely">Retain a Build Indefinitely</a>
							<br /><br />
						</li></ul>
				</content><sections xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
					<a name="RateBuildQuality" xmlns=""></a><a name="buildexplorer#RateBuildQuality" xmlns=""></a><h3 class="subHeading" xmlns="">Rate the Quality of a Completed Build</h3><div class="subSection" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
							<p xmlns="">When a build has completed, you can specify the quality of the resulting build. By doing this, you can communicate information about the build to your team. You might specify that a particular build should be ignored by marking it as Rejected. You might specify a build quality of Ready for Initial Test to indicate that testing can begin. The list of values for build quality can vary for each organization. For more information about how to customize the list of build quality values, see <a href="buildqualityvalues.htm" target="_blank">Adding and Removing Build Quality Values</a>.</p>
							<h4 class="subHeading" xmlns=""><b>To rate build quality from Build Explorer</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ul xmlns=""><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">In <b>Build Explorer</b>, in the Build Quality column, click the quality that you want to assign to the specified build.</p>
										</content>
									</li></ul></ddue:steps></div>
							<h4 class="subHeading" xmlns=""><b>To rate build quality from the build summary and details report</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ol class="ordered" xmlns=""><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">In the build report, click the list of build quality values to specify the quality of the completed build.</p>
										</content>
									</li></ol></ddue:steps></div>
						</content></div>
					<a name="QueueNewBuild" xmlns=""></a><a name="buildexplorer#QueueNewBuild" xmlns=""></a><h3 class="subHeading" xmlns="">Queue a New Build</h3><div class="subSection" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
							<p xmlns="">You can queue a new build for any build whose results appear in <b>Build Explorer</b>. You can also queue a new build from Team Explorer
. For more information, see <a href="runbuilds.htm" target="_blank">Running and Monitoring Builds</a>.</p>
							<h4 class="subHeading" xmlns=""><b>To queue a new build from Build Explorer</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ol class="ordered" xmlns=""><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">In <b>Build Explorer</b>, right-click the build result for which you want to queue a new build and click <b>Queue New Build</b>.</p>
											<p xmlns="">You can also click the build in the build results and then click <b>Queue New Build</b> on the toolbar.</p>
										</content>
									</li><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">Complete the details of the <b>Queue Build</b> dialog box. For more information, see <a href="runbuilds.htm" target="_blank">Running and Monitoring Builds</a>.</p>
										</content>
									</li></ol></ddue:steps></div>
						</content></div>
					<a name="DeleteBuild" xmlns=""></a><a name="buildexplorer#DeleteBuild" xmlns=""></a><h3 class="subHeading" xmlns="">Delete a Completed Build</h3><div class="subSection" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
							<p xmlns="">If a completed build is no longer required, you might choose to delete it.</p>
							<div class="alert" xmlns=""><table width="100%" cellspacing="0" cellpadding="0"><tr><th align="left">Caution </th></tr><tr><td>
								When you delete a build, you delete the related test results and files. The data that you delete by using this procedure cannot be recovered.<p></p>
							</td></tr></table><p></p></div>
							<p xmlns="">When you delete a build, the following information is permanently deleted:</p>
							<ul xmlns=""><li class="unordered">
									
										<b>Details</b> - Information about the completed build that appears in <b>Build Explorer</b>. This information includes build steps, requestor, and date and time queued. This data is stored in the Team Foundation Server
 database.<br /><br />
								</li><li class="unordered">
									
										<b>Drops</b> - File and folders that the build created and copied to the drop location.<br /><br />
								</li><li class="unordered">
									
										<b>Test Results</b> - Results of any automated tests executed during the build process or results of any test published against this build.<br /><br />
								</li><li class="unordered">
									
										<b>Label</b> - The version control marker associated with the specific file versions used by the build process.<br /><br />
								</li><li class="unordered">
									
										<b>Symbols</b> - The debugging symbols published to a symbol server during the build.<br /><br />
								</li></ul>
							<p xmlns="">
								<b>Required Permissions</b>
							</p>
							<p xmlns="">To complete this task, you must have the <b>Delete builds</b> permission set to <b>Allow</b>.</p>
							<h4 class="subHeading" xmlns=""><b>To delete a completed build</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ol class="ordered" xmlns=""><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">In <b>Build Explorer</b>, click the <b>Completed</b> tab.</p>
										</content>
									</li><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">Highlight one or more builds that you want to delete, right-click any of them, and then click <b>Delete Build</b>.</p>
											<p xmlns="">You can also highlight one or more builds and then click <b>Delete Builds</b> on the toolbar.</p>
										</content>
									</li><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">In the confirmation dialog box, click <b>OK</b> if you want to delete the build or builds.</p>
										</content>
									</li></ol></ddue:steps></div>
						</content></div>
					<a name="RetainIndefinitely" xmlns=""></a><a name="buildexplorer#RetainIndefinitely" xmlns=""></a><h3 class="subHeading" xmlns="">Retain a Build Indefinitely</h3><div class="subSection" xmlns=""><content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
							<p xmlns="">Each build definition has an associated retention policy that specifies how builds should be retained. You can override this retention policy if you specify that a build should be retained indefinitely.</p>
							<h4 class="subHeading" xmlns=""><b>To specify that a build should be retained indefinitely</b></h4><div class="subSection" xmlns=""><ddue:steps xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5"><ol class="ordered" xmlns=""><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">In <b>Build Explorer</b>, click the <b>Completed</b> tab.</p>
										</content>
									</li><li>
										<content xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
											<p xmlns="">Highlight one or more builds that you want to retain, right-click any of them, and then click <b>Retain Indefinitely</b>.</p>
											<p xmlns="">You can also highlight one or more builds and then click <b>Retain Indefinitely</b> on the toolbar.</p>
											<p xmlns="">In <b>Build Explorer</b>, a lock icon appears next to the builds that are retained indefinitely. You can repeat this procedure to clear the flag that indicates that the build should be retained indefinitely.</p>
										</content>
									</li></ol></ddue:steps></div>
						</content></div>
				</sections></div><h1 class="heading"><span id="seeAlsoNoToggle">See Also</span></h1><div id="seeAlsoSection" class="section"><h4 class="subHeading">Concepts</h4><a href="builddefinitions.htm" target="_blank">Creating and Working with Build Definitions</a><br /><a href="runbuilds.htm" target="_blank">Running and Monitoring Builds</a><br /><a href="buildingapps.htm" target="_blank">Building Applications</a><br /><br /></div><!--[if gte IE 5]>
			<tool:tip element="seeAlsoToolTip" avoidmouse="false"/><tool:tip element="languageFilterToolTip" avoidmouse="false"/>
		<![endif]--></div><div id="footer"><hr /><p /></div></div></body></html>